CD ROM Paradise Collection 4/CD ROM Paradise Collection 4 1995 Nov.iso/os2/galler21.zip/INSTALL.DAT/GALLERIA.INF

OS/2 Help File | 1994-08-13 | 47KB | 1,355 lines

ΓòÉΓòÉΓòÉ 1. Copyright ΓòÉΓòÉΓòÉ

                                    Galleria

                             Copyright (c) 1992-1994


                           Bitware Australia Pty. Ltd.
                                  P.O. Box 3097
                              Manuka  A.C.T.  2603
                                    Australia

                               Fax:  [phone]
                             CompuServe:  100033,340
                      Internet:  [e-mail]


                               All rights reserved


ΓòÉΓòÉΓòÉ 2. Acknowledgements and trademarks ΓòÉΓòÉΓòÉ

This software is based in part on the work of the Independent JPEG Group.

The Galleria and Galleria/CM executables are packaged using Info-ZIP's
compression utility. The installation program uses UnZip to process compressed
files from the install directory or diskette. Info-ZIP's software (Zip, UnZip
and related utilities) is free and can be obtained as source code or
executables from various anonymous-ftp sites on Internet, including
ftp.uu.net:/pub/archiving/zip/*.

ALL TRADEMARKS AND SERVICE MARKS ARE THE PROPERTY OF THEIR RESPECTIVE OWNERS.


ΓòÉΓòÉΓòÉ 3. Description ΓòÉΓòÉΓòÉ

Galleria is a general purpose tool for the management of bitmapped images. It
provides a window for the display of bitmaps at varying resolutions. Bitmaps
can be read from the OS/2 clipboard or from disk in numerous formats. Once
loaded, the displayed image can be edited (cropped, resized, rotated etc.) and
converted to monochrome or grayscale. The result can be transferred to other
applications via the clipboard or saved on disk in a different format. High
quality printed output can also be generated.

Galleria supports a file search function to list all bitmaps available. Also, a
multi-level undo/redo capability is provided to reverse previous edits.
Concurrent operation of most tasks (such as display, conversion, file save and
printing) is possible due to OS/2's multi-threading capability.

For general instructions on use of Galleria refer to the following
descriptions:

  Using Galleria as a bitmap viewer

  Using Galleria for file format conversion

  Using Galleria as a bitmap editor

  Using Galleria for screen capture

Galleria supports all common bitmap file formats including BMP, PCX, TIFF and
GIF. Kodak Photo-CD and JPEG (JFIF) formats are also supported for import.
Refer to Supported file formats for a complete list of supported file formats
(for import and export).

A number of the most commonly asked questions on use of Galleria and answers to
these can be found in Questions and answers below.

Refer to the online help for detailed descriptions on use of all aspects of
Galleria. Remember that pressing F1 while pull-down menus are active will
display help for entries in that menu.


ΓòÉΓòÉΓòÉ 3.1. Using Galleria as a bitmap viewer ΓòÉΓòÉΓòÉ

Galleria is an ideal utility for the display of collections of bitmapped images
found on disk or CD-ROM. Features such as the ability to select multiple files,
a screen-show capability with read-ahead logic, optimized display of images on
256 color display subsystems and comprehensive file format support make
Galleria a fast and flexible general purpose viewer.

The easiest way to display an image is to use the File open or File search
dialogs, select the desired file and press Open. Presuming that the file format
is recognised by Galleria, the image will be displayed in the main Galleria
window. If the image is larger than the current window size you can use the
scroll bars to move areas not displayed into view. Alternatively, you can
select Scale to window (from the Window menu) to have Galleria automatically
scale the image to fit the window.

To display the image without the window border etc. select Full screen from the
System menu. A keystroke or mouse click will restore the window controls.

You can magnify a portion of the displayed image by selecting Zoom (from the
Window menu) and clicking the left mouse button when the crosshairs are over
the area to be magnified. The contents of the floating Zoom window can scrolled
or the magnification changed.

Using the File open or File search dialogs you can also select multiple files
for display. Only one image will be loaded in memory at a time so as many files
as desired can be selected. The selected files constitute a list which can be
controlled by the List menu. These operations permit positioning within the
list to display each image in turn. Alternatively, you can use either the
keyboard or the pushbuttons in the status area to move up and down the list.
Select Start show mode to automatically display each successive image after a
specified time delay.

The list created above by selecting multiple files can be saved to disk as an
text file, edited using the OS/2 System Editor (or equivalent) and then
reloaded. This permits you to maintain catalogs to group like files together or
to create your own screen shows. The files which make up the list may be in
multiple directories or disks.

Galleria fully supports Kodak's Photo CD format for high quality imaging. Each
Photo CD contains a catalog of thumbnail views of all images and this overview
can be displayed by selecting Open from the Photo menu. To display the desired
image, simply double-click on the thumbnail in the Photo CD overview window.

Any displayed image can also be printed (in black and white or color) by
selecting File print. There is no need to first convert the image to the output
format as this will be done automatically. You can specify the output size and
quality desired. All printing will be queued and processed in the background so
you can initiate as many print requests as you want without waiting for the
first to finish. The print destination can be any locally- or LAN-attached
printer or it could be a logical device associated with fax software.


ΓòÉΓòÉΓòÉ 3.2. Using Galleria for file format conversion ΓòÉΓòÉΓòÉ

Galleria supports a large number of different image file formats and you can
use this capability to convert a specified file from one format to another.
This may be useful when you wish to import an image in an application which
does not support the original file format.

To change the file format you must first open the file by selecting the desired
file from the File open or File search dialogs and pressing Open. Then use File
save as to select the output format from the list displayed and press Save. You
can then import the new file created to another application.

Changing the file format can also save you disk space as some formats are more
economical than others. Galleria can read most file formats fairly quickly so
there is generally no penalty in selecting a file format based purely on output
size.

Galleria will also optimize the palette of each image saved so that only the
minimum space on disk is required.


ΓòÉΓòÉΓòÉ 3.3. Using Galleria as a bitmap editor ΓòÉΓòÉΓòÉ

Galleria can be used to perform basic edits on images and the image colors (or
palette). A multi-level undo/redo capability lets you experiment with changes
and revert to a previous state should the change not be to your liking.

Files to be edited are selected using the File open or File search dialogs and
pressing Open. You can then use the actions on the Image and Colors menus to
implement changes to the image or image colors respectively.

Image actions include Crop to cut a section from the image, Enlarge/reduce to
change the image size and Mirror or Rotate to change the orientation of the
image.

Colors actions permit you to make changes to just the image palette. This
includes Brightness/contrast and Color balance to make small changes to the
overall image to correct color casts etc. You can also use the Convert
monochrome, Convert grayscale and Convert color functions to convert from color
to grayscale to monochrome (black and white) or simply to reduce the number of
colors/shades in the image. Each conversion function has its own Options dialog
to enable you to fine tune the conversion.

Each change is added to the undo stack so you can revert to the image states
prior to the change if desired. You can also replay the changes. The undo stack
is controlled with the Edit undo and Edit redo actions. You can also specify
the number of undo levels to maintain in order to conserve memory/swapspace.

As a convenience you can display a menu of the most common edit actions by
clicking (and holding) the right mouse button anywhere on the image then
releasing the button when the pointer is over the desired action.


ΓòÉΓòÉΓòÉ 3.4. Using Galleria for screen capture ΓòÉΓòÉΓòÉ

Galleria can be integrated with the optional Galleria/CM utility for immediate
post-processing of images captured from the OS/2 desktop. This enables you to
modify or fine tune the captured image prior to it being saved or copied to the
clipboard.

To have Galleria invoked after the capture, simply select the Galleria or
Galleria (DDE) destination in the main Options dialog of Galleria/CM.
Subsequent captures will result in Galleria being invoked with the captured
image displayed.

Alternatively, you can set a File destination in Galleria/CM and process the
created files with Galleria at a later time.

(Note that GALLERIA.EXE must reside in the same directory as GALLERCM.EXE and
the LIBPATH statement in CONFIG.SYS must contain an explicit entry for the
directory in which the Galleria and Galleria/CM DLLs reside to enable the
integration.)


ΓòÉΓòÉΓòÉ 4. File menu ΓòÉΓòÉΓòÉ

Use the File menu to transfer images to/from disk, search for images on disk or
print the current image.

o New will replace the current image. A dialog box is displayed prompting for
  the new image size and fill color. These are normally used as a base for
  subsequent Merge operations.

o Open is used to load a new image from disk. A dialog box is displayed
  prompting for the name of the file to be read from disk.

o Search is used to search a number of disks for files matching the specified
  name or partial name. A dialog box is displayed prompting for disks to be
  searched and the file name to be found.

o Save will save the current image to disk. The image will be written to a file
  with the original file name and format or those used for the last save
  operation. The current conversion options will be applied prior to the save.
  The undo stack will also be cleared.

  Note that not all read files can be saved in the same format. If no output is
  possible for the format, this option will be disabled. Use Save as to save
  with a supported format.

o Save as will display a dialog box prompting for a new file name and/or format
  prior to saving to disk as in the Save operation above.

o Use the Photo CD menu to display the Photo CD overview window or set Photo CD
  import options.

  Select Open to display a window containing thumbnail views of all images on
  the Photo CD. If already displayed, the overview contents will be refreshed.

  To load a Photo CD image, double click on the thumbnail view in the window
  displayed. An image can be selected prior to all thumbnail views being
  displayed.

  Use Disk to select the id of the disk representing the desired Photo CD to be
  used for the Open action above.

  Select Options to display the Photo CD options dialog to preset import
  options.

o Delete will delete the current file from disk. You will be prompted for a
  confirmation.

o Print will print the current image to a specified printer. A dialog box will
  be displayed prompting for destination and print options.

o Preferences is used to display or change preferences. A dialog box is
  displayed permitting a number of operational settings to be changed.


ΓòÉΓòÉΓòÉ 4.1. File new ΓòÉΓòÉΓòÉ

The File new dialog is displayed to prompt for dimensions and fill color for a
new image.

Overtype the horizontal and vertical dimensions to set the new image size.

Select the fill color for the new image. The selected color can also be that
currently used for the OS/2 desktop.

New images of the size and color specified can be used as a base or border for
images merged from the clipboard.

Press OK to create a new image with the specified dimensions and color or
Cancel to ignore changes and exit with the current image unchanged.


ΓòÉΓòÉΓòÉ 4.2. File open ΓòÉΓòÉΓòÉ

The File open dialog prompts for the names of bitmap files on disk to be read
and displayed.

The path to a file is represented by a Disk, Directory and File name. Select
the desired disk and/or directory and all files matching the current mask will
be listed.

Edit the file name and press Open. Alternatively, double click on a name from
the list.

To select multiple files, click on the desired file names from the list and
press Open. Press All to select all listed files in the designated directory or
None to select none. The number of files currently selected is shown.

The files listed for the current disk and directory can be restricted by
entering a mask. The "*" and "?" wild values can be specified. Normal search
rules apply with the exception of file extension: when no extension is
specified (eg. *, b* or boat), only those files with extensions predefined in
the File extensions dialog will be listed. To list files with a specific
extension, include this extension in the name (eg. *.bmp). To list all files,
regardless of extension, enter *.*.

A history of previous file names or masks specified can be accessed by
selecting the drop-down arrow at the right of the file name/mask field.

Press Extensions to display or update the list of file extensions to be
included in the file list when none is specified.

Press Open to list all files matching the current mask, or open the file when
fully specified.

Press Cancel to exit the dialog with the current image unchanged.


ΓòÉΓòÉΓòÉ 4.3. File search ΓòÉΓòÉΓòÉ

Use the File search dialog to search a number of disks for files matching a
full or partial file name. All directories on the selected disk(s) will be
searched. When the required file is found, the remainder of the search
operation can be aborted.

Select the Disks to be searched from the list box. Multiple disks can be
targeted for the search.

Enter a full or partial file name in the Name/mask field. Wild characters "*"
or "?" can be specified. When no extension is provided, only those files with
extensions matching those in the File extensions  dialog will be listed.

Press Start/Stop to initiate/terminate the search.

Press Open to terminate the search and open the file selected from the list.
Alternatively, double-click on the desired file name.

To select multiple files, click on the desired file names from the list and
press Open. To select all files listed under a directory name, click on the
directory name in the list. Press All to select all listed files regardless of
directory or None to select none. The number of files currently selected is
shown.

Press Extensions to invoke the File extensions  dialog to select file
extensions for the search.

Press Cancel to terminate the search and leave the current image unchanged.


ΓòÉΓòÉΓòÉ 4.4. File save ΓòÉΓòÉΓòÉ

The File save dialog prompts for the name to be used for the image when saved
to disk.

The path to a file is represented by a Disk, Directory and File name. Select
the desired disk and/or directory and all files matching the current mask will
be listed.

Edit the file name and press Save. Alternatively, double click a a name from
the list to overwrite an existing file.

The files listed for the current disk and directory can be restricted by
entering a mask. The "*" and "?" wild values can be specified. Normal search
rules apply with the exception of file extension: when no extension is
specified (eg. *, b* or boat), only those files with extensions predefined in
the File extensions dialog will be listed. To list files with a specific
extension, include this extension in the name (eg. *.bmp). To list all files,
regardless of extension, enter *.*.

Press Extensions to display or update the list of file extensions to be
included in the file list when none is specified.

Press Save to list all files matching the current mask, or save the file when
fully specified.

Press Cancel to exit the dialog without saving the file.


ΓòÉΓòÉΓòÉ 4.5. File save as ΓòÉΓòÉΓòÉ

Use the File save as dialog to save the current image to disk with the file
name and format specified.

Select the desired file format from the list displayed. (The file name
extension will be changed to the default for that format.) Some formats have an
optional compressed form which may reduce the disk space required to store the
file created. Select Compressed to enable compression.

Specify the file name of the output file.

Press Save to save the file on disk with the specified name and format.

Press List to browse files in the current directory or change the output disk
and/or directory. Ensure that the desired file format is correct before
proceeding.

Press Cancel to terminate the dialog without saving the file.


ΓòÉΓòÉΓòÉ 4.6. File extensions ΓòÉΓòÉΓòÉ

Use the File extensions dialog to display or update the relevant file name
extensions to be listed when none is specified in the File open, File search
and File save dialogs. (Note that file list/search times can be reduced by
eliminating extensions not required.)

The list of file name extensions together with an optional short description is
displayed.

Press Add to add a new entry. Fill in the file name extension (maximum of three
characters) and an optional description and press OK.

Press Change to change the currently selected entry. Overtype the file name
extension and/or description and press OK.

Press Delete to delete the currently selected entry.

Press OK to accept these changes or Cancel to ignore any changes and exit with
the original entries.


ΓòÉΓòÉΓòÉ 4.7. Photo CD overview ΓòÉΓòÉΓòÉ

The Photo CD overview window shows an thumbnail view of each image on the Photo
CD.

The display an image, simply double-click on the image desired. A gray border
will be displayed around the thumbnail of the image selected.

To refresh the window contents after loading a new Photo CD, select Open from
the Photo menu.

The window can be maximized or minimized (hidden) as required. To redisplay a
minimized or hidden window, select Open from the Photo menu.

To close the window, double-click on the System icon.


ΓòÉΓòÉΓòÉ 4.8. Photo CD options ΓòÉΓòÉΓòÉ

The Photo CD options dialog is (optionally) displayed when a file with
extension .PCD is opened.

Photo CD files are stored in a number of resolutions (or sizes). Select the
desired Resolution. Make sure that you have enough memory and/or free swapspace
before selecting the higher resolutions.

Note that not all resolutions may be available for the selected image. In
particular, display at 6144x4096 resolution will only be supported for Pro
Photo CD images optionally scanned at 64Base.

To display such images more quickly, select the Grayscale option. Only the
grayscale component of the image will be read and displayed.

Select Prompt for options on load to display this dialog every time a Photo CD
image is opened.

Press OK to open the current file or save the settings for the next open. Press
Cancel to abort the open or leave the settings unchanged.


ΓòÉΓòÉΓòÉ 4.9. Metafile options ΓòÉΓòÉΓòÉ

The Metafile options dialog is displayed when a file with extension .MET is
opened. OS/2 metafiles (as vector files) are scalable and importing these files
requires conversion to bitmap format.

Specify the Background color and Size for the resulting bitmap. The color
selected can also be that currently used for the OS/2 desktop. To change the
size of the image, better resolution will result by re-opening the metafile
with a different size than subsequent use of the Enlarge/reduce edit option.

Press OK to open the file or Cancel to abort the open.


ΓòÉΓòÉΓòÉ 4.10. File print ΓòÉΓòÉΓòÉ

The File print dialog is displayed prior to a print operation to enable options
for the current print to be changed.

Specify the Queue for the print. To change printer driver settings see Setup
below. Note that the selected Queue can also represent drivers provided with
OS/2 fax software.

Select the Area percentage to limit the output size. The value specified is a
percentage of the total page area. Note that the image printed may be smaller
in area than that specified if it would otherwise overlap the border above.

Select a Border percentage to leave a blank edge along all sides of the page.
The value specified is a percentage of the page width and height.

For fine tuning monochrome output, the relative Color bias percentages can be
changed to lighten/darken areas of the image depending on the red/green/ blue
intensity of the original. A higher bias will result in a lighter tone for
areas of that color.

Additionally, the overall intensity can be changed by setting the desired
Brightness. Position the slider arm at the desired position.

The Preprocess image option will cause Galleria to use special rendering
techniques to generate high quality output on most monochrome and color
printers. This process may use large amounts of memory and elongate printing
times. This can be minimized by either decreasing the output size or selecting
a lower dpi setting (with Setup below).

Press Setup to change the driver settings for the currently selected Queue.
These settings will be retained until a different Queue is selected.

Press OK to start printing with the options selected or Cancel to ignore
changes and abort the current print operation.


ΓòÉΓòÉΓòÉ 4.11. Preferences ΓòÉΓòÉΓòÉ

Use the Preferences dialog to display or change personal preferences for use of
Galleria.

Select Show full file name in window title to display the full name of the
current file in the title of main window.

Select Use alternative file open and save dialogs to invoke alternative dialogs
for the File open and File save as operations. The default alternative dialogs
have a number of advantages over the standard OS/2 dialogs in that a list of
file extensions can be specified to filter the file names displayed.

Select Resize window to fit loaded image to change the window size so that it
is the same as the newly loaded image. The window will not be resized when
maximized.

Select Recall last used directory at startup to carry over the last used file
directory to subsequent sessions. If not selected, the directory specified as
the Working directory in the Settings notebook will be used.

Select Prompt for save when image changed or not yet saved to display a request
to save the current image when Galleria is closed or a new image or loaded. The
prompt will not be displayed if a current version of the image already exists
on disk.

Select Use palette management to enable Galleria to update the hardware palette
of your display adapter with colors from the currently displayed image. Colors
used by other applications or the OS/2 desktop may change as a result. This
option applies only when running in 256 (8-bit) color mode and with display
drivers that indicate that Palette Management is supported.

Set the image size value to control how Galleria draws the image on the screen
with the Paint directly for images larger than size. The size specified will be
that of the image at the current scaling factor.

Galleria can use two different methods to draw the image. When painting
directly the image will be copied directly to the screen but translation (where
required) will be done each time the image is drawn or scrolled. This method
will reduce the total amount of memory used, an important consideration with
very large images. The alternative method is to preprocess the image data which
results in faster redraws but may add considerably to memory usage. The value
you choose will depend on not only your hardware installed (CPU speed, total
memory and display adapter) but also on how efficiently the display driver is
implemented. You should experiment to find the best value for your setup.

Press OK to apply the selected preferences, Defaults to set default values or
Cancel to ignore changes.


ΓòÉΓòÉΓòÉ 5. List menu ΓòÉΓòÉΓòÉ

Use the List menu to perform operations on file lists. A list is automatically
created when multiple files are selected in the File open and File search
dialogs. Lists can also be read from disk.

o Use Open list to read and process an existing file list from disk. The List
  open dialog will be displayed. Files from the new list can be appended to
  those in the current list (if any).

o Use Save list to save the current list of files in a file on disk. This list
  can later be read with Open list above.

o The First, Previous, Next and Last options control enable positioning within
  the current list. Alternatively, the buttons in the information line can also
  be used to scroll up/down the files in the list. The selected image will
  replace the current one displayed.

o Use Edit to display the List edit dialog. This will display the names of all
  files in the current list. A specific file can be selected for display.

o Use Drop from list to remove the currently displayed file from the list. The
  corresponding file on disk will not be deleted.

o The Start show option will initiate a screen show of each image in the list
  in turn for the time set in the List show options dialog. When using this
  facility, images unable to be loaded for any reason will be skipped.

  Pressing any key or clicking the left mouse button will abort the screen
  show.

o Use Show options to set preferences for the screen show facility.


ΓòÉΓòÉΓòÉ 5.1. List open ΓòÉΓòÉΓòÉ

Use the List open dialog to load an existing file list from disk. This file may
have been created with List save or the System Editor. The file consists of
fully qualified file names, one to a line. Leading and trailing blanks will be
ignored.

Select Merge with current list to append the names of files from the selected
list with those in the current list (if any).

Press Open to process the selected list or Cancel to leave the current loaded
file/list unchanged.


ΓòÉΓòÉΓòÉ 5.2. List save ΓòÉΓòÉΓòÉ

Use the List save dialog to save the current file list on disk. This list can
subsequently be loaded with List open. The created list (ideally with file
extension .LST) can also be manipulated with the System Editor.

Press Save to save the current list or Cancel to abort the save.


ΓòÉΓòÉΓòÉ 5.3. List edit ΓòÉΓòÉΓòÉ

Use the List edit dialog to select a file from the current list or modify the
list.

To display a particular file, simply select it from the list and press OK.

Press Sort to sort the listed files by full file name.

Press Drop to delete the selected file from the list. The file on disk will not
be deleted.

Select Full path name to display the full file name of each listed file.

Press Cancel to leave the list elements and position unchanged.


ΓòÉΓòÉΓòÉ 5.4. List show options ΓòÉΓòÉΓòÉ

Use the List show options dialog to set preferences for the screen show
facility.

Select Start show in full screen mode to set full screen display for the images
when the show is started. Note that you may also want to set Scale to window on
the Window menu to scale the images to fit the screen size.

Select Wrap to beginning when end of list reached to restart display with the
first image after the last image in the current list is displayed. This permits
perpetual display of all images in the list.

Select Use read-ahead logic to preload next image to read and process the next
image in the list while the current image is being viewed. This may result in
nearly instantaneous display of the next image when it is selected. You may
wish to disable this logic if displaying large images on machines with minimal
memory.

Set the time delay to use between display of images when in screen show mode
with the Set show update interval to value.

Press OK to apply the selected preferences, Defaults to set default values or
Cancel to ignore changes.


ΓòÉΓòÉΓòÉ 6. Edit menu ΓòÉΓòÉΓòÉ

Use the Edit menu to transfer images to/from the clipboard or reverse Image
and/or Palette edits.

The following operations apply to clipboard operations:

o Copy places the current image in the clipboard. The clipboard can be used as
  either a temporary storage area or to facilitate transfer to another
  application. The clipboard copy will be converted as per the current
  conversion settings.

o Paste copies the bitmap from the clipboard and replaces the current image.

o Merge merges the bitmap in the clipboard with the current image. A rectangle
  with the same size as the image on the clipboard will be displayed to control
  placement.

  Position the top left corner of the displayed rectangle and press the left
  mouse button. The Merge operation can be aborted by pressing the Esc key.

o Peek displays the current clipboard contents prior to a Paste or Merge
  operation.

o Empty clipboard will clear the current clipboard contents.

The following options apply to the undo (or reversal) and redo of edits made to
the current image:

o Redo will re-apply the last Image or Palette edit operation(s) undone by Undo
  or Undo all below.

o Undo will restore the image to that displayed prior to the last Image or
  Palette edit operation.

o Undo all will restore the image to the original as loaded from the clipboard
  or read from disk.

o Undo levels permits setting of the number of undo levels to be retained. Each
  edit operation will require one level. When the number of edit operations
  exceeds the number set, earlier states will be discarded. Avoid setting too
  high a value when editing large images or virtual storage may be exhausted.
  When set to None, no previous states will be retained.


ΓòÉΓòÉΓòÉ 6.1. Edit peek ΓòÉΓòÉΓòÉ

Use the Edit peek dialog to display the current clipboard contents.

Press Paste or Merge to paste or merge the displayed image into Galleria.

Press Cancel to exit with the current image unchanged.


ΓòÉΓòÉΓòÉ 7. Image menu ΓòÉΓòÉΓòÉ

The following operations permit changes or edits to be made to the current
image:

o Crop is used to cut a rectangular portion from the current image. A
  size/position rectangle will be displayed to control the area of the image to
  be cut out.

  Position the top left corner of the size/position rectangle and press the
  left mouse button, then stretch the rectangle to the desired size and press
  the left mouse button again. The Crop operation can be aborted by pressing
  the Esc key.

o Enlarge/reduce is used to enlarge or reduce the image size. A dialog box will
  be displayed prompting for new horizontal and vertical dimensions.

o Mirror will flip the image around the vertical axis for a mirror image of
  that currently displayed.

o Invert will flip the image around the horizontal axis to invert the current
  image.

o Rotate left and Rotate right will turn the image 90 degrees anti-clockwise
  and clockwise respectively. Repeating this operation four times will restore
  the image to its original orientation.

o Border can be used to add a colored border to the image. A dialog is
  displayed prompting for the border color and width.

o Trim is used to crop the image edges. A dialog is displayed prompting for the
  edges to be trimmed and the trim width.

As an alternative to selecting options from the pull-down menu, click (and keep
depressed) the right mouse button anywhere on the displayed image. The action
will be performed when the mouse button is released over the desired option. If
no action is to be performed, move the pointer away from the popup menu and
then release the mouse button.


ΓòÉΓòÉΓòÉ 7.1. Image enlarge/reduce ΓòÉΓòÉΓòÉ

Use the Image enlarge/reduce dialog to change the size of the image.

The current horizontal and vertical dimensions are shown when the dialog is
invoked. Overtype these values with the new dimensions desired. Alternatively,
move the Proportional scaling slider to the left/right to decrease/ increase
the size while retaining the original image proportions.

The horizontal and vertical dimensions may not exceed a value of 8192.

Select Use resampling filter to increase the quality of the enlarged/reduced
image. This filter will remove "jaggies" from enlarged images and reduce other
unwanted artifacts. The number of colors used in the image may increase as a
result.

Press OK to accept these changes or Cancel to ignore changes and exit with the
original settings.


ΓòÉΓòÉΓòÉ 7.2. Image border ΓòÉΓòÉΓòÉ

Use the Image border dialog to add a colored border to the image. The color
selected can also be that used for the current OS/2 desktop.

Select the desired border color and width. Note that if the image currently has
256 colors, the selected color will be remapped to the closest in the image
palette.

Press OK to accept these changes or Cancel to ignore changes and exit with the
original settings.


ΓòÉΓòÉΓòÉ 7.3. Image trim ΓòÉΓòÉΓòÉ

Use the Image trim dialog to trim the image edges. This permits finer
adjustment in a cropping operation than may be possible with Image crop.

Select one or more edges to be trimmed. A strip of the set width (below) will
be cut from each of the edges selected.

Set the width to be trimmed from the above edges.

Press OK to accept these changes or Cancel to ignore changes and exit with the
original settings.


ΓòÉΓòÉΓòÉ 8. Colors menu ΓòÉΓòÉΓòÉ

The following operations permit changes to be made to the colors of the current
image:

o Brightness/contrast is used to change the overall brightness and/ or contrast
  of the image. Only the luminance component of the image will be changed. A
  dialog box will be displayed.

o Color balance is used to change the overall color balance of the image to
  remove color casts or make the image warmer/cooler in appearance. A dialog
  box will be displayed.

o Negative will invert all the colors in the image palette. This option would
  normally be used on monochrome images to reverse the black and white areas.

o Edit palette is used to change the color of entries in the image palette. A
  dialog box will be displayed.

o Convert monochrome will convert the image using black and white colors only.
  The mapping of original colors to either black or white will be governed by
  the settings in the Convert monochrome options dialog.

  Select 2 colors to initiate the conversion.

o Convert grayscale will convert the image using shades of gray only. The
  mapping of original colors to the respective shade of gray will be governed
  by the settings in the Convert grayscale options dialog.

  Select 8 colors, 16 colors, 32 colors, 64 colors or 256 colors to initiate
  the conversion.

o Convert color will map the original colors in the image to either a fixed
  palette or a palette with less colors than the original. This can result in
  smaller file sizes and/or better display with some monitor/adapter
  combinations. The mapping of the original colors will be governed by the
  settings in the Convert color options dialog.

  Select 8 colors, 16 colors or 256 colors to initiate the conversion.

Conversions make take some time to process. To abort the current conversion,
press the Escape key.


ΓòÉΓòÉΓòÉ 8.1. Color brightness/contrast ΓòÉΓòÉΓòÉ

Use the Color brightness/contrast dialog to change the overall overall
brightness and/or contrast of the image. Only the luminance component of the
image will be changed.

The distribution graph shows the range of luminance values in the image.

To darken/lighten the image, move the Brightness slider to the left/right. The
graph will be updated to show the new luminance range.

To decrease/increase image contrast, move the Contrast slider to the
left/right. The graph will be updated to show the new luminance range.

As a first attempt in setting optimal brightness and contrast for normal
images, first use the Brightness slider to center the graph (above) then use
the Contrast slider to expand (or contract) the graph to encompass the full
tonal range.

This function is not applicable to monochrome images.

Press Reset to restore the original brightness and contrast values.

Press OK to accept these changes or Cancel to ignore changes and exit with the
original settings.


ΓòÉΓòÉΓòÉ 8.2. Color balance ΓòÉΓòÉΓòÉ

Use the Color balance dialog to make overall changes to the image colors. Move
the slider for the desired color(s) to the right to slightly increase the
amount of this color in the image, or to the left to decrease the amount.

This dialog is useful for removing color casts or making images warmer/cooler
in appearance.

This function does not apply to monochrome or grayscale images.

Press Reset to restore the original color balance.

Press OK to accept these changes or Cancel to ignore changes and exit with the
original settings.


ΓòÉΓòÉΓòÉ 8.3. Color edit palette ΓòÉΓòÉΓòÉ

Use the Color edit palette dialog to change the values of individual colors in
the image palette.

A list of colors is displayed in decreasing order of frequency in the image.
The relative frequencies for each entry is displayed with the currently
selected entry indicated by a marker of the graph. The RGB component values of
the selected entry are represented by the sliders at the right.

To change a color, select that entry from the list and move each slider until
the desired new color is displayed. Any number of colors may be changed.

Press Reset to restore the currently edited color to its original value.

Press OK to accept these changes or Cancel to ignore changes and exit with the
original settings.


ΓòÉΓòÉΓòÉ 8.4. Convert monochrome options ΓòÉΓòÉΓòÉ

Use the Convert monochrome options dialog to fine-tune image conversion to
monochrome (black & white).

Select the Conversion technique. Options are Threshold for a simple re-map of
each color to either black or white, or Random dither, Ordered dither or Error
diffusion to dither or digitally halftone the image using dots of black or
white.

Choosing Threshold will give a sharper image but with the loss of the tonal
range of the original. Error diffusion will more accurately preserve the
overall tone. Random dither  or Ordered dither may be more suitable for some
applications.

To fine tune the output, change the relative Color bias percentages to
lighten/darken areas of the image depending on the red/green/blue intensity of
the original. A higher bias will result in a lighter tone for areas of that
color. Additionally, the overall intensity can be changed by setting the
desired Brightness. Position the slider arm at the desired position.

Select Enhance contrast to increase the contrast of the image or Sharpen for
more clearly defined edges.  Sharpen is recommended for Random dither but not
for Ordered dither.

Press Defaults to restore the default values for all settings.

Press OK to accept these changes or Cancel to ignore changes and exit with the
original settings.


ΓòÉΓòÉΓòÉ 8.5. Convert grayscale options ΓòÉΓòÉΓòÉ

Use the Convert grayscale options dialog to fine-tune image conversion to
shades of gray.

Select the Conversion technique. Options are Threshold for a simple remap of
each color to the closest shade of gray, or Error diffusion to dither or
digitally halftone the image using grays from the new palette. The former
method will result in a sharper image while the latter will more accurately
preserve the overall tone.

To fine tune the output, change the relative Color bias percentages to
lighten/darken areas of the image depending on the red/green/blue intensity of
the original. A higher bias will result in a lighter tone for areas of that
color. Additionally, the overall intensity can be changed by setting the
desired Brightness. Position the slider arm at the desired position.

Select Enhance contrast to increase the contrast of the image or Sharpen for
more clearly defined edges.

Press Defaults to restore the default values for all settings.

Press OK to accept these changes or Cancel to ignore changes and exit with the
original settings.


ΓòÉΓòÉΓòÉ 8.6. Convert color options ΓòÉΓòÉΓòÉ

Use the Convert color options dialog to fine-tune image conversion to a
different or reduced color palette.

Select the Conversion technique. Options are Closest color for a simple re-map
of each color to the nearest color in the new palette, or Error diffusion (fast
or normal) to dither or digitally halftone the image using colors from the new
palette. The latter method will more accurately preserve the overall color of
the original.

Press Defaults to restore the default values for all settings.

Press OK to accept these changes or Cancel to ignore changes and exit with the
original settings.


ΓòÉΓòÉΓòÉ 9. Window menu ΓòÉΓòÉΓòÉ

Use the Window menu to control the image display.

o Selecting Zoom will display a floating Zoom window (if not already
  displayed). The allows you to magnify a selected area of the image. You can
  also double-click the left mouse button anywhere on the image to display this
  Zoom window.

o Size to fit will resize the window to fit the displayed image.

o The Scale to window setting determines the current image magnification. When
  set, the image will be scaled to fit within the window. When not set, the
  image will be displayed full-size and scroll bars can be used to move the
  non-displayed portions of the image into view. This option can be toggled on
  or off.

  The current display magnification is shown as a percentage in the information
  area.

o The Information area setting will toggle on or off display of the information
  area at the bottom of the window.

o Background permits the window background color and pattern to be changed. A
  dialog box will be displayed prompting for color and pattern.


ΓòÉΓòÉΓòÉ 9.1. Zoom ΓòÉΓòÉΓòÉ

The Zoom window will be displayed when Zoom is selected from the Window menu
(or the left mouse button is double-clicked on an area of the main image). This
window will float above the window containing the main image.

To change the area magnified, position the crosshairs over the desired area of
main image and click the left mouse button. Alternatively, use the scroll bars
to move around the image.

To change the magnification, use the slider at the bottom of the window. The
current magnification will be displayed.


ΓòÉΓòÉΓòÉ 9.2. Window background ΓòÉΓòÉΓòÉ

Use the Window background dialog to change the color and pattern of the window.

Select the desired color and/or pattern from the set displayed. The currently
selected values are shown with a boxed border.

Press OK to accept these changes or Cancel to ignore changes and exit with the
original settings.


ΓòÉΓòÉΓòÉ 10. Help menu ΓòÉΓòÉΓòÉ

Use the Help menu for display of help information and product information.

o Help index will display and index of the help topics available.

o General help will display a general description of the program.

o Using help will display instructions on use of the help facility.

o Product information will display copyright and version information for the
  program.

o License information will display licensing information.


ΓòÉΓòÉΓòÉ 11. License details ΓòÉΓòÉΓòÉ

The License details dialog is displayed the first time you start Galleria. You
must enter both your license name and number at this time.

Enter your license name exactly as specified. You may use upper or lower case
but the name must match that supplied when the software was licensed.

Enter your license number exactly as specified. All 16 digits must be entered.
The license number must correspond to the name above.

Press OK to validate the license information and start the application or
Cancel to terminate.


ΓòÉΓòÉΓòÉ 12. License agreement ΓòÉΓòÉΓòÉ

The License agreement dialog is displayed after you complete your license
details to display the text of the agreement for use of this software.

You must read all of the agreement conditions and then press OK to complete the
licensing process. Press Cancel to abort.


ΓòÉΓòÉΓòÉ 13. Questions and answers ΓòÉΓòÉΓòÉ

The following are answers to commonly asked questions about Galleria:

Q.        When I display my 256 color image with Galleria the colors are
          displayed incorrectly. The image displays correctly in a full-screen
          session but not with Galleria. Why?

A.        As Galleria is a Presentation Manager application all writes to the
          screen must be done via the installed display driver. Not all display
          drivers currently support the palette management required to enable
          the hardware palette to be changed. Ask the supplier of your video
          adapter to provide you with a display driver which supports 'OS/2
          palette management'.

          Note that the 32-bit graphics engine (introduced in the 2.0 Service
          Pack) is a prerequisite for palette management support in OS/2 2.0.

Q.        When an image is loaded the display flashes and the desktop colors
          are changed. Why does this happen?

A.        On systems with 256 color (8-bit) display subsystems Galleria uses
          OS/2 palette management functions to load the image palette into the
          display hardware. This can cause other in-use color entries to be
          displaced, resulting in a mapping to the closest color in the
          modified palette. The desktop colors will be restored shortly after
          Galleria is minimized or closed.

Q.        If I save a 256 color image with Galleria and set this as the desktop
          background, the colors displayed are not correct. Why?

A.        Unfortunately, the OS/2 desktop does not use palette management
          functions to load the display hardware with the image palette.
          Reasonable images for use as the desktop background can be generated
          by using Galleria to convert the image to a 'standard' 16 or 256
          color palette.

Q.        The images displayed by Galleria seem to be more vivid and have more
          accurate colors than with other applications. Why is this?

A.        When 256 color images are displayed on the desktop, typically only
          240 colors are used by any application (and even less if other
          palette aware applications have the foreground). The remaining 16
          colors are used for the desktop and other applications which do not
          use palette management functions. Galleria optimizes the image
          palette (when first loaded and after each edit) to ensure that the
          highest frequency colors will always be displayed.

Q.        Why are the files Galleria writes different in size to those written
          by other applications?

A.        The files written by Galleria are often smaller due to a number of
          reasons:

          Galleria optimizes the palette to discard unused or duplicate
          entries. For file formats which permit variable palette sizes, a
          small saving in size is often possible.

          Galleria will also write files with the smallest bit size possible.
          For example, if the image uses up to 16 colors the file may be
          written in 4-bit format even if the original was 8-bit. The palette
          optimization above and edit operations can contribute to lesser
          colors being required.

          Also, Galleria uses its own compression algorithms which are
          optimized for file size. Large differences in the resultant file size
          may be experienced with file formats that use RLE-based compression
          techniques.

Q.        When I load an OS/2 metafile into Galleria or other applications, the
          image palette is incorrect. Is there a way around this?

A.        When editing an image to be saved in the OS/2 metafile format,
          convert the palette to the standard 16 or 256 colors with the Convert
          color function (using closest colors or error diffusion dither). This
          will ensure that the image displays correctly on a subsequent load.

Q.        Why won't Galleria read my WordPerfect graphic (WPG) file?

A.        The WPG format supports both raster (bitmap) and vector data. The
          latter files ( usually quite small) contain eg. line drawings.
          Galleria supports only the bitmap format for import and export.

Q.        Why does the loading of 24-bit color files (eg. Photo-CD and JPEG)
          take much longer than other images?

A.        On systems which only support display of 256 colors (or less)
          Galleria will translate all RGB files loaded to 256 colors (with the
          highest quality display possible). This is the major contribution to
          the delay in displaying the image.

Q.        Why doesn't Galleria present a display showing 'percent complete' on
          such things as loading a file?

A.        Galleria is fully multi-threading and there may be a number of
          activities occurring in parallel. For example, file opens, saves,
          prints, directory searches may all be active concurrently. In
          addition, Galleria may use read-ahead logic to preload files.
          Presentation of current status (and for each activity) is not as
          trivial as in applications which initiate a single task in response
          to input and wait for completion of that task.


ΓòÉΓòÉΓòÉ 14. Supported file formats ΓòÉΓòÉΓòÉ

The following file formats are supported by this version.

These file formats are supported for import (open):

o BMP - IBM OS/2 1.x bitmap

   Standards: Bitmap or Bitmap Array (first image only)
   Bits: 1, 4, 8 or 24
   Planes: 1

o BMP - IBM OS/2 2.x bitmap

   Standards: Bitmap or Bitmap Array (first image only)
   Bits: 1, 4, 8 or 24
   Planes: 1
   Compression: None, RLE4, RLE8 or RLE24

o BMP - Microsoft Windows 3.x bitmap

   Standards: Bitmap or Bitmap Array (first image only)
   Bits: 1, 4, 8 or 24
   Planes: 1
   Compression: None, RLE4 or RLE8

o EPS - Encapsulated Postscript (TIFF preview)

   Standards: As per Tagged Image File Format

o GIF - CompuServe Graphics Interchange Format

   Standards: GIF87a or GIF89a, single or multi-image, interleaved or
   non-interleaved
   Bits: 1 to 8

o IFF - Amiga Interchange Format Files

   Standards: Non-masked
   Bits: 1 to 8
   Compression: None, RLE

o IMG - Digital Research GEM

   Standards: Monochrome

o JPG - JPEG (JFIF)

   Standards: Baseline

o MAC - Apple MacPaint

   Standards: Monochrome, with or without header

o MET - OS/2 metafile

o MSP - Microsoft Paint

   Standards: Monochrome

o PBM/PGM/PPM - PBMPLUS

   Standards: Binary
   Bits: 1, 8 (grayscale) or 24

o PCD - Kodak Photo CD Master, Pro Photo CD

   Standards: Base/16, Base/4, Base, 4Base, 16Base, 64Base
   Bits: 8 (grayscale), 24

o PCX - ZSoft Paintbrush

   Standards: Version 2.8, 3.0
   Bits: 1 to 8
   Planes: 1, 4 (with 1 bit per pixel) or 3 (RGB)

o TGA - Truevision Targa-16/24/32

   Standards: Type 1, 2, 3, 9, 10 and 11, non-interleaved
   Bits: 1 to 8 (color-mapped) or 16, 24, 32 (RGB)
   Compression: None, RLE

o TIF - Tagged Image File Format

   Standards: Version 4.0, 5.0 (B, G, P and R), 6.0 (Baseline), Intel or
   Motorola byte ordering, first image only
   Bits: 1 to 8, 24
   Planes: 1
   Compression: None, Huffman (CCITT 1D), Packbits or LZW

o WPG - WordPerfect graphic

   Standards: Version 5.0, 5.1, bitmap only
   Bits: 1 to 8

These file formats are supported for export (save):

o BMP - IBM OS/2 1.x bitmap

   Bits: 1, 4, 8 or 24
   Planes: 1

o BMP - IBM OS/2 2.x bitmap

   Bits: 1, 4, 8 or 24
   Planes: 1
   Compression: None, RLE4, RLE8

o BMP - Microsoft Windows 3.x bitmap

   Bits: 1, 4, 8 or 24
   Planes: 1
   Compression: None, RLE4, RLE8

o GIF - CompuServe Graphics Interchange Format

   Standards: GIF87a
   Bits: 1 to 8

o JPG - JPEG (JFIF)

   Standards: Baseline

o MET - OS/2 metafile

o PCX - ZSoft Paintbrush

   Standards: Version 2.8, 3.0
   Bits: 1 or 8
   Planes: 1, 4 (with 1 bit per pixel) or 3 (RGB)

o TGA - Truevision Targa-24

   Standards: Type 1, 2, 9
   Bits: 8 (color mapped) or 24 (RGB)
   Compression: None, RLE

o TIF - Tagged Image File Format

   Standards: Version 4.0, 5.0 (TIFF B or P), Intel byte ordering
   Bits: 1, 4, 8 or 24
   Planes: 1
   Compression: None, Packbits

o WPG - WordPerfect graphic

   Standards: Version 5.0
   Bits: 1, 4 or 8

Note that (for all formats other than OS/2 metafiles and Photo CD) Galleria
ignores the file name extension when importing or exporting files. When a file
is read, the format is determined by examining header information contained
within the file.


ΓòÉΓòÉΓòÉ 15. Problems and diagnostics ΓòÉΓòÉΓòÉ

If the Galleria process detects an internal or external processing error, the
program will terminate.

To determine the cause of the error, restart Galleria with the -d switch
parameter (on the command line or as a parameter in the session settings) and
reproduce the sequence of events up to the failure.

This will log error information to a file GALLERIA.LOG in the same directory as
the executable. This file contains information which can be used to resolve
problems. Please record the program version number and symptoms (what action
was being performed at the time of the error) and return this information
together with the contents of GALLERIA.LOG so that the problem can be resolved.

Note that this log file will be over-written each time Galleria is started with
the -d switch. There is no performance penalty incurred in use of this error
logging facility.

Also, if Galleria should fail to read and/or display a file specifically
documented as being supported, please send this file to the address below on a
3.5 inch floppy disk (together with information on program version number,
hardware configuration etc). An updated version of Galleria will be returned.

Please send error reports or unsupported files to:

Bitware Australia Pty. Ltd.
P.O. Box 3097
Manuka  A.C.T.  2603
Australia